Перейти к основному содержимому

Ноды

Скриптовые файлы t-Plot содержат ноды. Ноды — это место, где пишется ваша история. В одном файле может быть столько нод, сколько нужно, но мы рекомендуем размещать ноды по файлам в соответствии со смыслом, например, одна глава в одном файле. Ноды помогают разделить историю на управляемые части, что облегчает работу с длинными повествованиями и ветвлением сюжета.

Каждая нода состоит как минимум из заголовка и тела. У каждой ноды должен быть хотя бы один заголовок — это title (название). Заголовок задаёт имя ноды, а тело содержит Yarn-скрипт с диалогами вашей игры.

Название ноды важно, так как игра использует его, чтобы понять, с какой ноды начать выполнение скрипта. Также название ноды используется при переходах (jump) между нодами.

Название ноды не отображается игроку.

Важно!

Названия нод должны начинаться с буквы и могут содержать только буквы, цифры и символы подчёркивания.

Например, FirstNode, First_Node и Node1 — допустимы, но First Node и 1stNode — нет.

Написание нод в текстовом редакторе

Пример ноды для t-Plot выглядит так:

title: Node_Title
---
Вот ваша первая строка!
Отлично!
===

В этом примере Node_Title — это название ноды, которое задаётся в заголовке title на первой строке. Вы также можете добавить другие заголовки, если это необходимо.

Маркер --- указывает, где начинается тело ноды. После этого можно писать скрипт на языке Yarn. Маркер === обозначает конец ноды. После него можно начинать следующую ноду.

Дополнительные параметры

Вы можете добавить дополнительные параметры, чтобы переопределить значения указанные в настройках, только для данной ноды

title: Node_Title
wait: 4
time_for_status: 3
reaction: std
checkpoint_name: "Chapter 1"
is_entry_point: true
---
Вот ваша первая строка!
Отлично!
===

wait

Параметр wait указывает сколько секунд нужно выждать перед отправкой следущего сообщения

time_for_status

Параметр time_for_status указывает сколько секунд нужно показывать статус отправки сообщения

reaction

Параметр reaction указывает какую реакцию показывать если пользователь отправил неожиданный ответ

checkpoint_name

Параметр checkpoint_name указывает имя чекпоинта, пользователь сможет вернуться к этому чекпоинту в любой момент

Важно!

checkpoint_name нужно указывать в кавычках, вы можете использовать любые символы кроме кавычек, но не забывайте что это имя будет отображаться пользователю в меню чекпоинтов, постарайтесь сделать его понятным и коротким, чтобы название могло поместиться в кнопку выбора чекпоинта

is_entry_point

Параметр is_entry_point указывает является ли нода точкой входа. Если установлен в true, нода будет использоваться в качестве стартовой для скрипта.

Важно!

Только одна нода может быть установлена в качестве точки входа.